Heap Specification Constants

You can pass a constant of type ATSUHeapSpec to the function ATSUCreateMemorySetting to specify whether you want ATSUI or your application to control memory allocation in ATSUI.

If you want ATSUI to perform memory allocation operations, pass the constant kATSUUseSpecificHeap. In this case, you must supply the correctly-prepared heap in the heapToUse field of the union ATSUMemoryCallbacks. If you want your own application-defined functions to control memory allocation, you must supply pointers to your application in the callback structure of the ATSUMemoryCallbacks union.

enum {
    kATSUUseCurrentHeap         = 0, 
    kATSUUseAppHeap             = 1, 
    kATSUUseSpecificHeap        = 2, 
    kATSUUseCallbacks           = 3 
};
typedef UInt32          ATSUHeapSpec; 

Constant descriptions

kATSUUseCurrentHeap
Indicates to ATSUI to perform memory allocation operations on the heap that is current at the time you call ATSUCreateMemorySetting. This is the default value if you do not call ATSUCreateMemorySetting.

kATSUUseAppHeap
Indicates to ATSUI to perform memory allocation operations only on the application heap, whether or not it is the current heap.

kATSUUseSpecificHeap
Indicates to ATSUI to perform memory allocation operations on the heap identified in the heapToUse field of the ATSUMemoryCallbacks union.

kATSUUseCallbacks
Indicates to use your application-defined functions to control memory allocation.
VERSION NOTES
Available beginning with ATSUI 1.1.


© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)